EnableAliases

在您使用 WriteAxisAlias 和 WriteIOAlias 配置好轴和 I/O 模组的别名索引后，请使用 EnableAliases 来启用别名功能。一旦启用，所有与轴和 I/O 模组相关的 API 中的 Index 参数将会对应到别名索引。

语法

KsError EnableAliases(
     BOOL Active
);

参数

Active：此参数决定是否使用别名，设置 TRUE 以启用；FALSE 停用别名，预设为 FALSE。

回传值

如果此函式执行成功，会回传 errNoError，否则会传回错误码。如需更多有关错误码的资讯，请参阅 KsError 清单。

备注

获取各驱动器的细节，并使用供应商、产品与别名来识别各驱动器，若驱动器未依正确顺序插入，请重新排列驱动器的列表，并在 KINGSTAR 子系统开始后使用此函式。

可用的 EtherCAT 状态

ecatOP

范例

// Define aliases for axes
#define AxisX 101
#define AxisZ 102
#define AxisC 103

// Apply the aliases
nRet = WriteAxisAlias(1, AxisX);
nRet = WriteAxisAlias(2, AxisZ);
nRet = WriteAxisAlias(0, AxisC);
nRet = EnableAliases(TRUE);

使用需求

参见

GetAliasesStatus

ReadIOAlias

WriteIOAlias